Skip to content

ci(docs-truth): fail fast on unusable org read token - #55

Merged
peycheff-com merged 1 commit into
mainfrom
claude/docs-truth-token-guard
Jul 29, 2026
Merged

ci(docs-truth): fail fast on unusable org read token#55
peycheff-com merged 1 commit into
mainfrom
claude/docs-truth-token-guard

Conversation

@mindburnlabs

@mindburnlabs mindburnlabs commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

What

Adds an explicit pre-check to the public reusable Docs Truth workflow for MINDBURN_ORG_READ_TOKEN.

Before any checkout, the workflow now verifies that the token:

  • is non-empty;
  • can read the selected subject repository;
  • can read the .github inventory repository;
  • can read the private docs ledger repository; and
  • can read the private dev-orchestration runner repository.

The check reports the exact repository and HTTP status when entitlement is missing.

Why

workflow_call.secrets.required: true validates only that callers declare the key. It does not prove that a value reaches the run or that the token can read every repository used by the workflow.

The July fleet probe exposed both failure modes:

  • private/internal subject repositories failed at Checkout subject repo;
  • public subject repositories passed their own checkout, then failed at Checkout docs truth ledger.

Checking only the subject would therefore produce a false green preflight for public subjects. This PR probes the complete checkout read-set and turns misleading actions/checkout failures into an entitlement-specific error.

Validation

  • actionlint .github/workflows/docs-truth-public.yml
  • Ruby YAML parse with aliases enabled
  • git diff --check
  • Fleet evidence on current main: all nine selected callers now complete Docs Truth successfully with MINDBURN_ORG_READ_TOKEN.

Refs HELM-311 and HELM-41.

@mindburnlabs
mindburnlabs requested a review from a team as a code owner July 21, 2026 07:59
@strix-security

Copy link
Copy Markdown

Strix is installed on this repository, but we couldn't run this PR security review because this workspace's trial has ended. Add a card to resume code reviews here.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Fail before checkout when MINDBURN_ORG_READ_TOKEN is empty or cannot read the subject, inventory, ledger, or pinned runner repositories. This covers the public-subject/private-dependency failure mode observed in the fleet probe and makes token entitlement errors explicit.

Signed-off-by: mindburnlabs <mindburnlabs@gmail.com>
@peycheff-com
peycheff-com force-pushed the claude/docs-truth-token-guard branch from 1e426b7 to 3cdbe92 Compare July 29, 2026 13:31
@peycheff-com peycheff-com changed the title ci(docs-truth): fail fast when the org read token is missing or unscoped ci(docs-truth): fail fast on unusable org read token Jul 29, 2026
@peycheff-com
peycheff-com merged commit b9040b9 into main Jul 29, 2026
7 of 11 checks passed
@peycheff-com
peycheff-com deleted the claude/docs-truth-token-guard branch July 29, 2026 13:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants